stamp
POST
/api/v1/accounts/:account_id/customers/:customer_id/customer_cards/:id/stamp
Add stamps
Adds stamps to a customer’s loyalty card. Triggers ledger entries, wallet pass updates, and push notifications. Pass skip_notifications to stamp silently.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id
|
Must be a number. | Required |
Store (account) ID |
customer_id
|
Must be a number. | Required |
Customer ID |
id
|
Must be a number. | Required |
Customer card ID |
stamps
|
Must be a number. | Required |
Number of stamps to add (e.g. 1, 3) |
skip_notifications
|
Must be one of: true, false, 1, 0.
|
Optional |
When true, stamp changes bypass notifications |
Error Codes
| Code | Description |
|---|---|
401
|
Unauthorized – invalid or missing API token |
404
|
Store, customer, or customer card not found |
422
|
Validation failed – check `errors` for details |